home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games: Greatest Hits 1996 / Amiga Games: Greatest Hits 1996.iso / userbox / publicdomain / replacer / replacer.doc < prev    next >
Text File  |  1996-06-05  |  9KB  |  240 lines
  1.  
  2.  
  3.                                  Replacer
  4.  
  5.                                 Wersja 2.13
  6.  
  7.                         Data kompilacji: 11.05.1996
  8.  
  9.  
  10.           Copyright (c) 1996 Przemysîaw Jeû (Warhawk/SubBlahBlah)
  11.  
  12.                                  FreeWare
  13.  
  14.                             BlahBlah Production
  15.  
  16.  
  17.  
  18.  
  19.             SPIS TREÔCI
  20.  
  21.             1. Status.
  22.             2. Co to jest i jak tego uûywaê?
  23.             3. BlahBlah? A to co?!
  24.             4. Problemy.
  25.             5. Thanx & Greetz
  26.             6. Przyszîoôê.
  27.             7. Historia.
  28.             8. Kontakt z autorem.
  29.  
  30.  
  31. 1. Status.
  32.  
  33.     "Replacer"  jest  programem  typu  FreeWare  co  oznacza,  ûe moûesz go
  34. NIEODPÎATNIE  kopiowaê  i rozpowszechniaê. Zastrzegam sobie jednak wszelkie
  35. prawa autorskie. Niedozwolone sâ jakiekolwiek zmiany w samym programie, jak
  36. i w dokumentacji, czy w pozostaîych plikach.
  37.  
  38. ---------------------------------------------------------------------------
  39.     NIE ODPOWIADAM ZA ÛADNE STRATY WYNIKÎE Z NIEPRAWIDÎOWEGO DZIAÎANIA,
  40.                       BÂDÚ UÛYWANIA TEGO PROGRAMU!!!
  41. ---------------------------------------------------------------------------
  42.  
  43.  
  44. 2. Co to jest i jak tego uûywaê?
  45.  
  46.    Program  ten  sîuûy  do  podmieniania wszystkich ikon w podanym katalogu, a
  47. odpowiadajâcych  podanemu wzorcowi (dest icon) na ikonë, która jest opisana
  48. przez  drugi  wzorzec  (source icon).
  49.  
  50.    Program   dziaîa  rekurencyjnie.  Oznacza  to,  ûe  w  podanym  katalogu
  51. przeglâda  takûe  wszystkie podkatalogi w poszukiwaniu ikon odpowiadajâcych
  52. podanemu wzorcowi.
  53.  
  54.    Jako  wzorzec  uwaûany  jest  "obrazek"  ikony. W przypadku, gdy chociaû
  55. jeden  piksel  ikony  sprawdzanej róûni sië od odpowiadajâcego mu pikselowi
  56. ikony wzorcowej, wówczas ikona jest pomijana.
  57.    Natomiast   w  momencie  stwierdzenia  identycznoôci  obu  ikon  program
  58. dokonuje wymiany samego obrazka na zawarty w ikonie "Source Icon".
  59.  
  60. ---------------------------------------------------------------------------
  61.    UWAGA!!!  Wszystkie  ustawienia  zapisane  w ikonie nie ulegajâ zmianie.
  62. Zmienia sië tylko sam "wyglâd" ikony modyfikowanej.
  63. ---------------------------------------------------------------------------
  64.  
  65. Przykîad:
  66.  
  67.    Aby  dokonaê  modyfikacji  wszystkich  ikon  "wyglâdajâcych"  jak  ikona
  68. "Workbench:System.info"  na  ikonë  "Workbench:Prefs.info" w CAÎYM katalogu
  69. "Workbench:", naleûy uruchomiê "Replacer'a" i kolejno:
  70.  
  71.    1. Przenieôê ikonë "Workbench:System.info" na ikonë "DestIcon".
  72.  
  73.    2. Przenieôê ikonë "Workbench:Prefs.info" na ikonë "SourceIcon".
  74.  
  75.    3. Wpisaê do pola "Path" nazwë katalogu roboczego: "Workbench:" lub
  76.       przy  pomocy  przycisku  "Get",  a  nastëpnie  requestera  wybraê ten
  77.       katalog i nacisnâê "OK".
  78.  
  79.    4. Aby rozpoczâê naleûy wcisnâê przycisk "Start".
  80.  
  81.  
  82.    Po  zakoïczonym  procesie  modyfikacji  ikon  w  podanym katalogu (w tym
  83. przypadku  jest  nim  "Workbench:")  program  wyôwietli  niewielkie okienko
  84. statystyczne.  Zawarte  w nim informacje dotyczâ iloôci ikon porównanych ze
  85. wzorcem  ("Icons  checked:")  i  iloôci  ikon,  które zostaîy zmodyfikowane
  86. ("Icons replaced:").
  87.  
  88.  
  89.    Program moûna uruchamiaê zarówno z poziomu DOS'a, jak i Workbencha.
  90.  
  91. ---------------------------------------------------------------------------
  92.    UWAGA!!!  W  przypadku  uruchamiania programu z poziomu DOS'a niezbëdnym
  93. warunkiem do zadziaîania programu jest uruchomiony Workbench. ze wzglëdu na
  94. specyficzne  rozwiâzanie dotyczâce odsîugi programu program dziaîa tylko (i
  95. wyîâcznie) pod Worbench'em.
  96. ---------------------------------------------------------------------------
  97.  
  98.    Pobieranie  ikon  wzorcowej  i  ûródîowej moûliwe jest takûe przy pomocy
  99. gadget'ów "GetSrc" i "GetDst".
  100.  
  101.    Gadget  "Drawers"  sîuûy  do  dodawania  do  kaûdego  katalogu ikony lub
  102. podmiany  juû  istniejâcej  na  ikonë  ûródîowâ przy zachowaniu poprzednich
  103. ustawieï, jeûeli katalog miaî juû ikonë.
  104.  
  105.    Podmiana pojedynczych ikon na ûródîowâ, jest moûliwe przez przeniesienie
  106. ikony  docelowej  (do  podmiany) na okno programu. Ustawienia pozostajâ jak
  107. wyûej.
  108.  
  109.     Istnieje  takûe  moûliwoôê "rëcznego"  nagrywania  ikon  Src  i Dst przy
  110. pomocy  requester'a  przez uûycie gadget'ów SaveSrc i SaveDst. W przypadku,
  111. gdy  ikona  o  podanej  nazwie  istnieje,  zostanie dokonana tylko podmiana
  112. "wyglâdu",  w  przeciwnym wypadku uûytkownik zostanie poproszony o wybranie
  113. typu nagrywanej ikony.
  114.  
  115.     Opcja "About" zawiera dane o autorze i pozdrowienia.
  116.  
  117.  
  118. 3. BlahBlah? A to co?!
  119.  
  120.     Program  ten jest kolejnâ produkcjâ spod znaku BlahBlah.  BlahBlah jest
  121. grupâ  zajmujâcâ  sië  pisaniem  (na  razie prostych) programów uûytkowych.
  122. Jeôli chcesz sië dowiedzieê czegoô wiëcej - poczytaj dokumentacje do innych
  123. naszych produkcji (lista nie jest peîna!):
  124.  
  125.     BDHTFileEditor
  126.     Bin2Asm
  127.     Bin2C
  128.     CrazyText
  129.     Enigma
  130.     Life
  131.     MemoryViewer
  132.     ModInfo
  133.     PLScene
  134.     SwaperBox
  135.     XPKCut
  136.     LhAReq
  137.  
  138.  
  139. 4. Problemy.
  140.  
  141.    Program  nie  rozpoznaje wielkoôci czcionki. Aktualnie poprawnie pracuje
  142. przy  czcionkach  o  wielkoôci  8  (takûe  proporcjonalnych). W przyszîoôci
  143. (w kolejnej wersji) zostanie to poprawione.
  144.  
  145.  
  146. 5. Thanx & Greetz
  147.  
  148.    Chciaîbym podziëkowaê nastëpujâcym osobom:
  149.  
  150.    Banito (za uûyczenie Blizzard'a IV 1230-50 do testów)
  151.    Elis
  152.    Kamil Iskra
  153.    LeMUr / Fire & Bla²
  154.    Thufor / Fire & BlahBlah
  155.  
  156.    Oraz pozdrowiê (kolejnoôê przypadkowa):
  157.  
  158.    mojâ dziewczynë Edytë :)
  159.    Bodzio / The Edge
  160.    Perry / Fire & Clan
  161.    Katarzynkë Trawa
  162.    
  163.    ...i wszystkich o których zapomniaîem!
  164.  
  165.  
  166. 6. Przyszîoôê.
  167.  
  168.    Kolejna  wersja  powstanie (przypuszczalnie...) w momencie, kiedy trochë
  169. lepiej poznam system Amigi, wiëc w czasie bliûej nie okreôlonym.
  170.  
  171.  
  172. 7. Historia.
  173.  
  174. 1.00 - pierwotna wersja byîa absolutnym prototypem, który nigdy nie opuôciî
  175.    mojego dysku twardego. Do kopiowania ikon uûywaîa ona systemowej komendy
  176.    COPY,  co  bezpoôrednio  wpîynëîo na konkretne wady tej wersji programu.
  177.    Mianowicie  byî  on  strasznie  wolny (za kaûdym razem od nowa wczytywaî
  178.    komendë   COPY),   dosîownie   "zarzynaî"   twardy   dysk"  tym  ciâgîym
  179.    wczytywaniem,  i,  co  najwaûniejsze, nie zachowywaî pierwotnym ustawieï
  180.    ikon,  tzn.  wszystkie  parametry  ikony,  wîâcznie  z tooltype'ami byîy
  181.    bezpowrotnie  tracone,  bez  moûliwoôci  odzyskania  ich  w  jakikolwiek
  182.    sposób.  Parametry  byîy  podawane  z  CLI (stamtâd teû tylko moûna byîo
  183.    uruchomiê  program).  Ikona byîa rozpoznawana przez porównanie wielkoôci
  184.    pliku,  co  byîo strasznie niedokîadne i prowadziîo do czëstych pomyîek;
  185.    wielkoôê  czësto  zgadzaîa  sië tylko przez zawarte w ikonie tooltype'y.
  186.    Procedura  sprawdzania,  czy badany plik jest ikonâ byîa niesystemowa, a
  187.    tym samym niezgodna ze standartem OS. (18.03.96)
  188.  
  189. 1.01  - poprawiîem sprawdzanie rozszerzenia ".info" przez uûycie systemowej
  190.    funkcji    MatchPatternNoCase().    Program   korzystaî   z   biblioteki
  191.    icon.library,  co  umoûliwiîo  porzucenie  chorego pomysîu wykorzystania
  192.    komendy  COPY  i  pozwoliîo  na zachowywanie pierwotnych ustawieï ikony.
  193.    (19.03.96)
  194.  
  195. 1.02  -  zmodernizowaîem procedurë wchodzenia do podkatalogów. Wprowadziîem
  196.    dynamicznâ   alokacjë   pamiëci  zamiast  korzystania  ze  stosu,  co  w
  197.    poprzednich wersjach czësto prowadziîo do jego przepeînienia. (20.03.96)
  198.  
  199. 1.03  -  niewielkie  zmiany  w  sposobie  wprowadzania  danych do programu.
  200.    (30.03.96)
  201.  
  202. 1.04  -  ogromna  zmiana  w  sposobie porównywania ikony ze wzorem. Program
  203.    sprawdza ikonë pod kâtem identycznoôci obu struktur Image. (31.03.96)
  204.  
  205. 2.00  -  do  programu  dodaîem  GUI  (graphic  user  interface  - graficzny
  206.    interfejs  uûytkownika),  co pozwoliîo na wygodniejszâ obsîugë programu.
  207.    Zastosowanie   ikon  "APP"  przyczyniîo  sië  do  stworzenia  moûliwoôci
  208.    wizualnej  kontroli  wybranych  ikon wzorcowych. Procedura podmiany moûe
  209.    byê  przeprowadzona  wielokrotnie, po kolejnych zmianach ikon wzorcowych
  210.    i/lub  ôcieûki  dostëpu  do  katalogu  roboczego  przy pomocy requestera
  211.    "reqtools.library". (17.04.96)
  212.  
  213. 2.10  -  dodaîem  listwë  statusowâ,  na której podczas pracy programu jest
  214.    wyôwietlany katalog, w który aktualnie pracuje program. (19.04.96)
  215.  
  216. 2.11  -  przy  pomocy okna "APP" zostaîa dodana opcja podmiany pojedynczych
  217.    ikon przez przeniesienie ich na okno programu. (21.04.96)
  218.  
  219. 2.12  -  dodaîem  kilka  gadget'ów  sîuûâcych  miëdzy innymi do rëcznego (z
  220.    poziomu  requestera)  wybierania  ikon  wzorcowych, a takûe dodaîem tryb
  221.    pracy  programu,  w którym do kaûdego katalogu w podanej ôcieûce dostëpu
  222.    dodaje  ikonë  (w  przypadku,  gdy katalog nie miaî ikony) lub podmienia
  223.    ikonë tego katalogu na podanâ. (26.04.96)
  224.  
  225. 2.13 - dodanie opcji "rëcznego" (przy uûyciu request'erów) nagrywania ikon.
  226.     (11.05.96)
  227.  
  228.    Kolejna wersja juû wkrótce...
  229.  
  230.  
  231. 8. Kontakt z autorem.
  232.  
  233.    Jeôli  masz  jakieô  sugestie zwiâzane z "Replacer'em", znalazîeô jakieô
  234. bîëdy i byki, chcesz przesîaê mi kartkë, trochë kasy - pisz na adres:
  235.  
  236.  
  237.                          Przemysîaw "Warhawk" Jeû
  238.                             ul. Korfantego 9/1
  239.                               43-200 Pszczyna
  240.